PocketNES v9.9k b3.2
-=-=-=-=-=-=-=-=-=-=

It's a Nintendo Entertainment System (NES) emulator for the GameBoy Advance. 
But you already knew that, didn't you?

Getting Started
-=-=-=-=-=-=-=-

 For PogoShell Users
 -=-=-=-=-=-=-=-=-=-=-=

   v1 Users
   -=-=-=-=
   Copy pocketnes.gba into your plugins directory.  Then, add to filetypes:

   nes 9 /.plugins/pocketnes.bin
   nez 9 /.plugins/pocketnes.bin

   v2 Users
   -=-=-=-=

   Copy pocketnes.mbz into your plugins directory.  Then, add to pogo.cfg with
   all the other filetype entries:

   nes 1 pocketnes.mbz 1
   nez 1 pocketnes.mbz 1

   v1 and v2 Users
   -=-=-=-=-=-=-=-

   Now that you successfully have a copy of pocketnes ready for pogoshell to
   use, you can compress smaller rom files.  It's as simple as.

   nez_cmp small_rom.nes small_rom.nez

   Trying to compress larger roms won't achieve anything.  Include compressed
   .nez and non-compressed .nes files in your Pogoshell root to use.

   NOTE: Compressed NES files, to be used properly by PocketNES-k, must end
         with a z.  Non-compressed NES files, to be used properly, must NOT
	 end with a z.

 For Everyone Else
 -=-=-=-=-=-=-=-=-

 Before you can use PocketNES, you need to add some NES roms to the emulator.
 You can do this with the enclosed build tool called build.  Building is
 as simple as:

 build -o compilation.gba -s splash_screen.raw rom1.nes rom2.nes ...

Controls
-=-=-=-=

Menu navigation:  Press L+R to open the menu, A to choose, B (or L+R again)
to cancel.

Unscaled modes:  L and R buttons scroll the screen up and down.

Scaled modes:  Press L+SELECT to adjust the background.

Speed modes:  L+START switches between throttled/unthrottled/slomo mode.

Quick load:  R+START loads the last savestate of the current rom.

Quick save:  R+SELECT saves to the last savestate of the current rom (or makes
a new one if none exist).

Sleep:  START+SELECT wakes up from sleep mode (activated from menu or 5
minutes of inactivity)

Other Stuff
-=-=-=-=-=-=-

Link transfer:  Sends PocketNES to another GBA.  The other GBA must be in
  multiboot receive mode (no cartridge inserted, powered on and waiting with
  the "GAME BOY" logo displayed).  Only one game can be sent at a time, and
  only if it's small enough to send (approx. 200kB or less). A game can only
  be sent to 1 (one) Gameboy at a time, disconnect all other gameboys during
  transfer.

Multi player link play:  Go to the menu and change Controller: to read
  "Link2P"/"Link3P"/"Link4P", depending on how many Gameboys you will use.
  Once this is done on all GBAs, leave the menu on all slaves first, then
  the master, the game will restart and you can begin playing.
  If the link is lost (cable is pulled out, or a GBA is restarted),
  link must be re-initiated, this is done by a restart on the master and
  then selecting the appropriate link and leave the menu. The slaves doesn't
  have to do anything.

Use an original Nintendo cable!

GameBoy Player:
To be able to check for the GameBoy Player one must display the GameBoy Player
logo, the easiest way to get it is by downloading it from my homepage.
Otherwise you can rip it from any other game that displays it (SMA4 & Pokemon Pinball).
There is no actuall use for it yet, but the check is there and I would appreciate
if people could test it on their GameBoy Players, it says in the menu
"PocketNES v9.9k b1 on GBP".

Supports Mapper:
0,1,2,3,4,5,7,9,11,15,16,17,18,19,21,23,25,32,33,34,64,65,66,67,68,69,
70,71,72,73,75,76,78,79,80,86,87,92,93,94,97,99,105,151,152,180,228,232
Just because PocketNES supports a mapper doesn't mean all games using that
mapper works correctly.


For more information on the original PocketNES, go to The Official Site at
http://www.pocketnes.org/

For information on the hacked PocketNES, go to
http://kuwanger.malfunct.net/PocketNES-k.php

! Thank you:
-=-=-=-=-=-=
Warder1 - page hosting, testing
Titney - page hosting, testing
reio-ta - coding help, testing
Costis - Multiplayer help
Chris Owens - Multiplayer testing
Markus Oberhumer - LZO compression library
Jeff Frohwein - MBV2
Yuichi Oda - xLA
Ben Parnell - FCEU src.
www.lik-sang.com - Flash Advance Linker
PocketNES forum - for all the support and ideas
nesdev community - you know

Many thanks to everyone who donated money - you know who you are.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Neal Tew
zxcvzxcv@netzero.net
http://nes.pocketheaven.com/

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Fredrik Olsson
flubba@passagen.se
http://hem.passagen.se/gba.html

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Kuwanger
neutrino99@hotmail.com
http://kuwanger.malfunct.net/Pocketnes-k.php
